home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / ifconfig.z / ifconfig
Encoding:
Text File  |  2002-10-03  |  12.0 KB  |  265 lines
  1.  
  2.  
  3.  
  4. iiiiffffccccoooonnnnffffiiiigggg((((1111MMMM))))                                                      iiiiffffccccoooonnnnffffiiiigggg((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ifconfig - configure network interface parameters
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////iiiiffffccccoooonnnnffffiiiigggg [ ----vvvv ] _i_n_t_e_r_f_a_c_e _a_d_d_r_e_s_s__f_a_m_i_l_y [ _a_d_d_r_e_s_s [ _d_e_s_t__a_d_d_r_e_s_s ] ]
  13.           [ _p_a_r_a_m_e_t_e_r_s ]
  14.      ////uuuussssrrrr////eeeettttcccc////iiiiffffccccoooonnnnffffiiiigggg _i_n_t_e_r_f_a_c_e [ _p_r_o_t_o_c_o_l__f_a_m_i_l_y ]
  15.      ////uuuussssrrrr////eeeettttcccc////iiiiffffccccoooonnnnffffiiiigggg [ ----vvvv ] -_a
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _i_f_c_o_n_f_i_g is used to assign an address to a network interface and/or
  19.      configure network interface parameters.  _i_f_c_o_n_f_i_g is invoked at boot time
  20.      from /_e_t_c/_i_n_i_t._d/_n_e_t_w_o_r_k to define the network address of each interface
  21.      present on a machine; you can also use it once the system is up to
  22.      redefine an interface's address or other operating parameters.  The
  23.      _i_n_t_e_r_f_a_c_e parameter is a string of the form ``name unit'', for example,
  24.      eeeennnnpppp0000.  Using the ----aaaa option shows status for all interfaces on the
  25.      machine.
  26.  
  27.      If specified, the ----vvvv option causes additional information about specified
  28.      interfaces to be displayed, including speed.
  29.  
  30.      Since an interface can receive transmissions in differing protocols, each
  31.      of which may require separate naming schemes, it is necessary to specify
  32.      the _a_d_d_r_e_s_s__f_a_m_i_l_y, which can change the interpretation of the remaining
  33.      parameters.  Currently, just the ``inet'' address family is supported.
  34.  
  35.      For the Internet family, the address is either an Internet address
  36.      expressed in the Internet standard ``dot notation'' (see _i_n_e_t(3N)), or a
  37.      hostname present in the _h_o_s_t_s(4) file, /_e_t_c/_h_o_s_t_s.  (Other _h_o_s_t_s
  38.      databases, such as _n_a_m_e_d and NIS, are ignored.)
  39.  
  40.      Only the superuser can modify the configuration of a network interface.
  41.  
  42.      The following parameters can be set with _i_f_c_o_n_f_i_g:
  43.  
  44.      uuuupppp             Mark an interface uuuupppp.  This can be used to enable an
  45.                     interface after an iiiiffffccccoooonnnnffffiiiigggg ddddoooowwwwnnnn.  It happens
  46.                     automatically when setting the first address on an
  47.                     interface.  If the interface was reset when previously
  48.                     marked down, the hardware is reinitialized.
  49.  
  50.      ddddoooowwwwnnnn           Mark an interface ddddoooowwwwnnnn.  When an interface is marked ddddoooowwwwnnnn,
  51.                     the system does not attempt to transmit messages through
  52.                     that interface.  If possible, the interface is reset to
  53.                     disable reception as well.  This action does not
  54.                     automatically disable routes using the interface.
  55.  
  56.      aaaarrrrpppp            Enable the use of the Address Resolution Protocol in
  57.                     mapping between network level addresses and link level
  58.                     addresses (default).  It is used by a variety of data link
  59.                     network interfaces such as Ethernet.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiiffffccccoooonnnnffffiiiigggg((((1111MMMM))))                                                      iiiiffffccccoooonnnnffffiiiigggg((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----aaaarrrrpppp           Disable the use of the Address Resolution Protocol.
  75.  
  76.      aaaalllliiiiaaaassss _a_d_d_r     Establish an additional network address for this
  77.                     interface.  This can be useful in permitting a single
  78.                     physical interface to accept packets addressed to several
  79.                     different addresses such as when you are changing network
  80.                     numbers and you wish to accept packets addressed to the
  81.                     old interface.  Another case is when you'd like to have
  82.                     multiple addresses assigned to a single network interface.
  83.                     The bbbbrrrrooooaaaaddddccccaaaasssstttt and nnnneeeettttmmmmaaaasssskkkk options can also be used in
  84.                     conjunction with the aaaalllliiiiaaaassss option.  When using aliases you
  85.                     may have to change the configuration of _r_o_u_t_e_d, especially
  86.                     if aliases are on different networks than the primary
  87.                     address.  Aliases are added as host entries in the routing
  88.                     tables for _r_o_u_t_e_d.  See _r_o_u_t_e_d(1M) for more information on
  89.                     this.
  90.  
  91.      ----aaaalllliiiiaaaassss|ddddeeeelllleeeetttteeee _a_d_d_r
  92.                     Deletes a previously added alias.
  93.  
  94.      mmmmeeeettttrrrriiiicccc _n       Set the routing metric of the interface to _n, default 0.
  95.                     The routing metric is used by the routing protocol
  96.                     (_r_o_u_t_e_d).  Higher metrics have the effect of making a
  97.                     route less favorable; metrics are counted as addition hops
  98.                     to the destination network or host.
  99.  
  100.      nnnneeeettttmmmmaaaasssskkkk _m_a_s_k   Specify how much of the address to reserve for subdividing
  101.                     networks into subnetworks.  The mask includes the network
  102.                     part of the local address and the subnet part, which is
  103.                     taken from the host field of the address.  The mask can be
  104.                     specified as a single hexadecimal number with a leading
  105.                     0x, with a dot-notation Internet address, or with a
  106.                     pseudo-network name listed in the network table
  107.                     _n_e_t_w_o_r_k_s(4).  The mask contains 1's for the bit positions
  108.                     in the 32-bit address that are to be used for the network
  109.                     and subnet parts, and 0's for the host part.  The mask
  110.                     should contain at least the standard network portion, and
  111.                     the subnet field should be contiguous with the network
  112.                     portion.
  113.  
  114.      mmmmttttuuuu _n          Specify device maximum transmission unit value.  This may
  115.                     not be supported on all devices.  Currently, this may be
  116.                     used to lower ethernet MTU's below 1500 bytes to
  117.                     interoperate with buggy adapters and network hardware.
  118.  
  119.      bbbbrrrrooooaaaaddddccccaaaasssstttt _a_d_d_r Specify the address to use to represent broadcasts to the
  120.                     network.  The default broadcast address is the address
  121.                     with a host part of all 1's.
  122.  
  123.      _d_e_s_t__a_d_d_r      Specify the address of the correspondent on the other end
  124.                     of a point-to-point link.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiiffffccccoooonnnnffffiiiigggg((((1111MMMM))))                                                      iiiiffffccccoooonnnnffffiiiigggg((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      ddddeeeebbbbuuuugggg          Enable driver-dependent debugging code; usually, this
  141.                     turns on extra console error logging.
  142.  
  143.      ----ddddeeeebbbbuuuugggg         Disable driver-dependent debugging code.
  144.  
  145.      hhhhiiiigggghhhhbbbbwwww         Flag an interface as being a high-bandwidth interface.
  146.                     This acts as a hint which allows upper layer protocols to
  147.                     adjust their behaviour to optimise performance (e.g. TCP
  148.                     will be less aggressive with ACKing).
  149.  
  150.      ----hhhhiiiigggghhhhbbbbwwww        Remove the high-bandwidth flag from an interface.
  151.  
  152.      lllliiiinnnnkkkk{{{{0000,,,,1111,,,,2222}}}}    Enable driver-specific feature 0-2.
  153.  
  154.      ----lllliiiinnnnkkkk{{{{0000,,,,1111,,,,2222}}}}   Disable driver-specific feature 0-2.
  155.  
  156.      pppprrrriiiimmmmaaaarrrryyyy        This parameter makes the specified interface the primary
  157.                     interface for networking.  In cases where no interface or
  158.                     interface address is specified by an application, the
  159.                     'primary' interface will be preferred.
  160.  
  161.      rrrrssssppppaaaacccceeee _v_a_l_u_e   Specifies the default receive space used by TCP when
  162.                     communicating over the interface.  Use a value of 0 to
  163.                     clear this parameter and use the system-wide default.
  164.  
  165.      ssssssssppppaaaacccceeee _v_a_l_u_e   Specifies the default send space used by TCP when
  166.                     communicating over the interface.  Use a value of 0 to
  167.                     clear this parameter and use the system-wide default.
  168.  
  169.      _i_f_c_o_n_f_i_g displays the current configuration for a network interface when
  170.      no optional parameters are supplied.  If a protocol family is specified,
  171.      _i_f_c_o_n_f_i_g reports only the details specific to that protocol family.
  172.  
  173. NNNNOOOOTTTTEEEESSSS
  174.      Network interfaces on Silicon Graphics systems can only receive and not
  175.      send packets that use ``trailer'' link-level encapsulation.  Therefore,
  176.      _i_f_c_o_n_f_i_g does not accept the ttttrrrraaaaiiiilllleeeerrrrssss parameter.
  177.  
  178.      For 100baseTX interfaces, such as 'ef', LINK0 being set indicates that
  179.      the device is operating at full-duplex.  It is not currently possible to
  180.      force full- or half-duplex by setting or clearing this flag.
  181.  
  182.      Currently options such as 'metric' are not handled for IP aliases;
  183.      adjusting the metric will affect only the primary address.  'broadcast'
  184.      and 'netmask' are the only options currently known to work properly with
  185.      IP aliases.
  186.  
  187. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  188.      Messages indicating the specified interface does not exist, the requested
  189.      address is unknown, or the user is not privileged and tried to alter an
  190.      interface's configuration.
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. iiiiffffccccoooonnnnffffiiiigggg((((1111MMMM))))                                                      iiiiffffccccoooonnnnffffiiiigggg((((1111MMMM))))
  203.  
  204.  
  205.  
  206. FFFFIIIILLLLEEEESSSS
  207.      /etc/hosts                       host-address database
  208.      /etc/config/ifconfig-?.options   site-specific options (1 file per
  209.                                       interface)
  210.      /etc/config/ipaliases.options    interface-specific ip alias addresses
  211.  
  212. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  213.      netstat(1), network(1M).
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.